home *** CD-ROM | disk | FTP | other *** search
/ United Public Domain Gold 2 / United Public Domain Gold 2.iso / utilities / pu665.dms / pu665.adf / grasp / gl.man < prev    next >
Text File  |  1992-09-09  |  5KB  |  144 lines
  1.  
  2.  
  3.  
  4.     GL 2.1                                                    03.09.92
  5.  
  6.  
  7.  
  8.     ABOUT
  9.  
  10.     GL is an Amiga GL file player. It implements a subset of the GRASP
  11.     commands on Amiga GL files created with GLIB. These are based on
  12.     MS-DOS GL files, but with an intermediate conversion stage to
  13.     improve the playback speed and conversion quality.
  14.  
  15.     This is an update to GL 1.3 which played a number of MS-DOS GL
  16.     files with no intermediate conversion.
  17.  
  18.     Amiga GL files are available from me, for one. See CONTACT INFO
  19.     section below for more information. Distrubition is somewhat
  20.     limited due to the pornographic nature of most GL animations.
  21.  
  22.     GL is one of the four programs in the GL 2.1 distribution. The
  23.     others are the librarian GLIB, the .PIC/.CLP converter PIC2HL, and
  24.     the font extracter GLFONT.
  25.  
  26.     GL is Copyright © 1992 by John Bickers.
  27.  
  28.  
  29.     PLAYING AN ANIMATION
  30.  
  31.     From the command line, type GL followed by the name of the
  32.     animation you want to play. There are no command line options.
  33.  
  34.     From the Workbench, click on the animation you want to play, then
  35.     shift-double-click on GL. Or double-click on GL and select an
  36.     animation from the requester.
  37.  
  38.     If you are running the freely distributable version of GL, an
  39.     information requester will pop up. Press Enter or click on the
  40.     requester button, and the animation will proceed.
  41.  
  42.     While playing, there are some key commands available. Most
  43.     importantly, the Esc key will terminate the animation. Many
  44.     animations loop endlessly, and Esc is the only way to stop them.
  45.     Secondly, GL animations are often full of small delays between
  46.     each frame. Pressing a key or clicking the left mouse button will
  47.     skip the next delay. For example, you can accelerate many
  48.     animations by holding down the 'n' key.
  49.  
  50.     GL uses double buffering to avoid pixel fizz etc. If you move the
  51.     GL screen to the back, and/or cause the GL window to be
  52.     deactivated, GL will eventually (at the next buffer swap or delay
  53.     spot) notice and pause. To continue the animation, make the GL
  54.     screen the front one, then click on it.
  55.  
  56.  
  57.     FROM MS-DOS TO AMIGA
  58.  
  59.     Previous GL players played directly from the MS-DOS format. This
  60.     version requires an intermediate conversion step, where you take
  61.     the MS-DOS animation apart with GLIB, convert each picture into
  62.     an Amiga format, modify the .TXT file, then put everything back
  63.     together using GLIB.
  64.  
  65.     Only a subset of the available GRASP commands have been
  66.     implemented at the moment. I implemented most commands I found in
  67.     the animations I have, but I've ignored sound and text commands,
  68.     and many of the fades. Let me know if the lack of some command
  69.     is a problem for any conversion you're doing.
  70.  
  71.     The reasons for this intermediate step are fourfold. First, the
  72.     player had to understand a variety of input picture formats. With
  73.     the conversion step, the player only has to understand the Amiga
  74.     format. For example, GL 1.3 could not play animations that
  75.     contained .GIF files.
  76.  
  77.     Secondly, the quality of the conversion of each picture depended
  78.     on the player. With the conversion step, you can use programs
  79.     like HamLab do the conversion. They can be used to convert a wider
  80.     range of likely input files, from .GIF through to the PCPaint C,
  81.     J, L, and M types (using PIC2HL).
  82.  
  83.     Thirdly, the conversion step provides flexibility between which
  84.     MS-DOS format the original used, and which Amiga format your
  85.     converted file uses. For example, GL 1.3 always played MS-DOS
  86.     VGA animations in LORES mode, while AmiGRASP 1.0a (by Koh Kian
  87.     Beng) always played them in HAM mode. In practise, some VGA
  88.     animations only use 32 colors, which makes LORES ideal, while
  89.     others use many more, which makes HAM ideal.
  90.  
  91.     And finally, because the converted data is in an Amiga format,
  92.     it can be loaded and displayed much more rapidly than previous
  93.     players could manage.
  94.  
  95.  
  96.     CREDITS
  97.  
  98.     GL is written by John Bickers using SAS C 5.10a.
  99.  
  100.     GRASP is a product of Microtex Industries, Inc. It's a sort of
  101.     slideshow animation program on PClones.
  102.  
  103.     The reqtools.library is used for Workbench messages and the
  104.     startup notice. ReqTools is Copyright (c) Nico François.
  105.  
  106.     The xpkmaster.library and sublibraries are the work of U. Dominik
  107.     Mueller and colleagues. Dominik can be reached on the net at the
  108.     address: umueller@amiga.physik.unizh.ch.
  109.  
  110.     The GL icon with the two faces is a DEVO thing, from their album
  111.     "TOTAL DEVO".
  112.  
  113.  
  114.     DISTRIBUTION
  115.  
  116.     GL is Copyright © 1992 by John Bickers.
  117.  
  118.     Distribution is via normal channels. That is, distribute it for
  119.     free, or for Fred Fish like costs, but not more. And remember to
  120.     include the documentation.
  121.  
  122.     This program is shareware. A registration fee of 40 NZD is
  123.     requested. Pay however you like, as long as the result can be
  124.     cashed (this rules out credit cards).
  125.  
  126.  
  127.     CONTACT INFO
  128.  
  129.     If you're having problems, want to make suggestions, want to
  130.     register, want to discuss conversion, or are keen to move data, I
  131.     can be reached at:
  132.  
  133.         John Bickers
  134.         214 Rata St
  135.         Naenae 6301
  136.         New Zealand
  137.  
  138.     Or: jbickers@templar.actrix.gen.nz
  139.  
  140.  
  141.     DISCLAIMER
  142.  
  143.     It works on my machine.
  144.